Skip to content

docs: add AGENTS.md with Bengal-specific agent guardrails#237

Merged
lbliii merged 1 commit intomainfrom
lbliii/agents-md
Apr 20, 2026
Merged

docs: add AGENTS.md with Bengal-specific agent guardrails#237
lbliii merged 1 commit intomainfrom
lbliii/agents-md

Conversation

@lbliii
Copy link
Copy Markdown
Owner

@lbliii lbliii commented Apr 20, 2026

Summary

  • Adds a top-level AGENTS.md modeled on the Pounce template, adapted to Bengal: north star, design philosophy, stakes, escape hatches, anti-patterns, done criteria, and review norms.
  • Encodes the rules agents most often get wrong here — PEP 758 unparenthesized except, the core mixin allow-list closed after PR refactor: eliminate Site mixin hierarchy, migrate to protocol types #194, deferred-import cycles, immutable page pipeline invariants, the ty diagnostic floor, and the diagnostics-sink-not-loggers rule for bengal/core/.
  • Pure docs change; no code under bengal/ touched, so no changelog fragment needed.

North star, design philosophy, stakes, escape hatches, anti-patterns,
done criteria, and review norms — modeled on the Pounce template and
adapted to Bengal (free-threading, immutable pipeline, core passivity,
PEP 758 except, mixin allow-list, deferred-import cycles, ty floor).
@lbliii lbliii merged commit f1d47a8 into main Apr 20, 2026
15 checks passed
@lbliii lbliii deleted the lbliii/agents-md branch April 20, 2026 16:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant